home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / vceldemo.arc / ANIMATE4.DOC next >
Text File  |  1990-03-13  |  8KB  |  195 lines
  1.  
  2.  
  3.  
  4.  
  5.                                  ANIMATE4.PRG
  6.                                     (9/88)
  7.  
  8.                             (c) 1988 by Tom Hudson
  9.  
  10.                             Program & Documentation
  11.                                  by Tom Hudson
  12.  
  13.  
  14.                         This is a Public Domain utility.
  15.  
  16.  
  17.     ANIMATE4.PRG is the fourth generation animation display program for the
  18.     CYBER family of products:
  19.  
  20.       CYBER STUDIO
  21.       CYBER CONTROL
  22.       CYBER PAINT
  23.       CYBER VCR and
  24.       CYBER SCULPT
  25.  
  26.     This program will display delta-file AND sequence animations, 
  27.     created either by CYBER PAINT in .DLT or .SEQ format, or CYBER
  28.     STUDIO/CONTROL in .DLT format.  Delta files (with initial
  29.     .PI1 files and data files with a .DLT extender) take up more
  30.     space on disk than sequence files (composed of only file file,
  31.     which takes up about 30-40% less disk space than a comparable
  32.     .PI1/.DLT combination).  Sequence files take up the same amount
  33.     of space in memory as delta files, however.  
  34.  
  35.     This version of ANIMATE will also display all color-palette
  36.     changes in .SEQ files created with CYBER PAINT 2.0, and no longer
  37.     uses the double-buffering command of the previous animation
  38.     programs.  (The buffering is now automatic, and very fast.)
  39.  
  40.  
  41.     To display .DLT files, click on the .DLT button in the custom
  42.     file selector.  Likewise, to display .SEQ files, click on the
  43.     .SEQ button.  
  44.  
  45.     Disk drives may be altered with the drive-letter buttons.  Paths
  46.     may be moved through with the "Back" and Reread" buttons.
  47.  
  48.     As with my previous animate programs, there are 2 operating modes:
  49.     Batch and manual.  Animations can be run in sequence from a hard disk
  50.     and/or floppy drives in batch modes, with chained animation files
  51.     easily accomodated.  NOTE:  You can only chain delta files -- 
  52.     sequence files are NOT chainable.
  53.  
  54.  
  55.                                   MANUAL MODE
  56.  
  57.     The manual mode is invoked by simply double-clicking on the
  58.     ANIMATE4.PRG icon.  The program will display help information
  59.     -- take some time to read it for the basic commands such as
  60.     (F)orward, etc.)  Click on OK, and you will be presented
  61.     with my new file selector.  
  62.  
  63.     Loading Delta Files:
  64.  
  65.     Select the delta file you want to run (it can be either stereo or
  66.     monoscopic).  The program will load the delta file and its
  67.     associated .PI1 file (L_ and R_ versions, if the animation is in
  68.     stereo).  It will ask if you have more delta file sections (this will
  69.     only happen if you chained the animation), click on the appropriate
  70.     button.  If there are more delta files, the file selector will
  71.     reappear, and you must select the name of the chained delta file.
  72.  
  73.     After all delta files are loaded, the program will start animation.
  74.  
  75.     Loading Sequence Files:
  76.  
  77.     Click on the .SEQ button, and the sequence files on the disk will
  78.     be displayed.  Select the sequence file you want to run (sequence
  79.     files can only be monoscopic).  The program will load it and
  80.     begin running automatically.  Press the F key to turn
  81.     Ping-pong mode on or off.
  82.  
  83.  
  84.                                   BATCH MODE
  85.  
  86.     The animator program will run in a batch mode for continuous
  87.     demonstrations of animations.  This is done through the use of a run
  88.     control file, which has the extension .RUN.  To work properly, the
  89.     ANIMATE4.PRG program must be installed via the "Install application"
  90.     selection on the desktop.  Install ANIMATE4.PRG as a GEM application
  91.     with document type RUN.
  92.  
  93.     To execute the animator in batch mode, just double-click on the
  94.     appropriate .RUN file.
  95.  
  96.     The .RUN file format is discussed after the keyboard command
  97.     section.
  98.  
  99.  
  100.                                KEYBOARD COMMANDS
  101.  
  102.     Once you have an animation sequence running, the following keys are
  103.     operational:
  104.  
  105.     F1-F10 -- Control the speed of the animation from slow (F1) to fast
  106.     (F10).  Default speed is F6.
  107.  
  108.     Help -- Aborts the animation and displays the file selector for a new
  109.     animation in both batch and manual modes.  Changes to manual mode if
  110.     running in batch mode.
  111.  
  112.     Undo -- Quits the program, returning to the desktop.
  113.  
  114.     F -- Toggles the animation direction from forward-only to a
  115.     forward-reverse ping-pong effect.  Default is forward-only.
  116.  
  117.     Space bar -- Pauses and single-steps the animation.  Press any other
  118.     key to resume normal operation.
  119.  
  120.     Alt-L -- Locks the keyboard to prevent tampering during demonstrations,
  121.     no keys will have any effect.  Press Alt-L again to unlock the
  122.     keyboard.
  123.  
  124.  
  125.                                .RUN FILE FORMAT
  126.  
  127.     The .RUN file is a simple text file, which can be created with any text
  128.     editor or 1st Word.  Each line has the following format:
  129.  
  130.     PATH,FILE,MORE[,FWDBAK,BUFFER,SPEED,TIMES]
  131.  
  132.     PATH -- Drive and path of animation delta file or sequence file, may
  133.     be upper or lower case.  Example: A:\ANIMATIONS\
  134.  
  135.     FILE -- Filename of animation delta file, in upper or lower case.
  136.     Example: CARGO.DLT.  If it is a sequence file, the example would
  137.     be CARGO.SEQ.
  138.  
  139.     MORE -- Indicates whether or not there are more delta files to be
  140.     chained to this one.  Enter Y if there are more, or N if there are not.
  141.     May be upper or lower case.  If the Y is entered, the next line
  142.     contains the filename of the next delta file in the chain, and the
  143.     extra parameters on this line are not used.  Any number of files may be
  144.     chained.  For sequence files, use an N.
  145.  
  146.     FWDBAK -- Indicates whether the animation should be run forward only
  147.     (F) or forward/reverse (R).  May be upper or lower case.  Not used if
  148.     the file has more delta files chained to it.
  149.  
  150.     BUFFER -- This parameter is no longer used in ANIMATE4.PRG,
  151.     but should be included for compatibility with older programs.
  152.     Simply include a B in this slot.
  153.  
  154.     SPEED -- Indicates the speed at which the animation should be run.
  155.     Values range from 0-9, corresponding to function keys F1-F10.
  156.  
  157.     TIMES -- The number of times the animation is to be run before going to
  158.     the next animation.  In forward/reverse mode, this is the number of
  159.     complete forward/reverse cycles; in forward mode, it is the number of
  160.     normal animation cycles.  A value of 9999 indicates to run the
  161.     animation forever, until HELP or UNDO is pressed.  Use 9999 when
  162.     you're creating a .RUN file that will be used to load one animation
  163.     from a floppy disk and display it forever.
  164.  
  165.     Example batch files:
  166.  
  167.     b:\,cargo.dlt,n,f,b,8,9999
  168.  
  169.     Runs the CARGO animation forward at speed 8, forever.
  170.  
  171.  
  172.     c:\animate\,hollow.dlt,y
  173.     c:\animate\,hollowb.dlt,n,f,b,9,9999
  174.  
  175.     Runs the two-part HOLLOW animation (HOLLOW.DLT and HOLLOWB.DLT, in the
  176.     ANIMATE folder on drive c:) forward at speed 9, forever.
  177.  
  178.  
  179.     a:\,bounce.dlt,n,r,b,7,20
  180.     b:\,atari.dlt,y
  181.     b:\,atarib.dlt,n,f,b,9,25
  182.  
  183.     Runs the BOUNCE animation from drive A: 20 times in forward/reverse
  184.     mode at speed 7, then runs the two-part ATARI animation
  185.     (ATARI.DLT and ATARIB.DLT) from drive B: 25 times at speed 9
  186.     forward.  When the ATARI animation is complete, operation resumes
  187.     with BOUNCE again and continues until HELP or UNDO is pressed.
  188.  
  189.     a:\tutorial\,tesla.seq,n,f,b,9,9999
  190.  
  191.     Runs the TESLA animation on the CYBER PAINT disk forward, at
  192.     speed 9, forever (or as long as the hardware holds out,
  193.     whichever comes first).
  194.  
  195.